#折れ線グラフ

折れ線グラフは、データ ポイントを直線上にプロットする方法です。多くの場合、傾向データ、または 2 つのデータセットの比較を表示するために使用されます。

const config = {
  type: 'line',
  data: data,
};

#データセットのプロパティ

名前空間:

  • data.datasets[index]- このデータセットのみのオプション
  • options.datasets.line- すべてのライン データセットのオプション
  • options.elements.line- すべてのオプション線要素
  • options.elements.point- すべてのオプション点要素
  • options- チャート全体のオプション

折れ線グラフを使用すると、データセットごとにいくつかのプロパティを指定できます。これらは、特定のデータセットの表示プロパティを設定するために使用されます。たとえば、線の色は一般的にこのように設定されます。

名前 タイプ スクリプト可能 インデックス可能 デフォルト
backgroundColor Color はい - 'rgba(0, 0, 0, 0.1)'
borderCapStyle string はい - 'butt'
borderColor Color はい - 'rgba(0, 0, 0, 0.1)'
borderDash number[] はい - []
borderDashOffset number はい - 0.0
borderJoinStyle 'round'|'bevel'|'miter' はい - 'miter'
borderWidth number はい - 3
clip number|object|false - - undefined
cubicInterpolationMode string はい - 'default'
data object|object[]|number[]|string[] - - 必要
drawActiveElementsOnTop boolean はい はい true
fill boolean|string はい - false
hoverBackgroundColor Color はい - undefined
hoverBorderCapStyle string はい - undefined
hoverBorderColor Color はい - undefined
a008cca​​9-1365-4833-b3f1-016c3ed5c52c number[] はい - undefined
hoverBorderDashOffset number はい - undefined
hoverBorderJoinStyle 'round'|'bevel'|'miter' はい - undefined
hoverBorderWidth number はい - undefined
indexAxis string - - 'x'
label string - - ''
order number - - 0
pointBackgroundColor Color はい はい 'rgba(0, 0, 0, 0.1)'
pointBorderColor Color はい はい 'rgba(0, 0, 0, 0.1)'
pointBorderWidth number はい はい 1
pointHitRadius number はい はい 1
pointHoverBackgroundColor Color はい はい undefined
pointHoverBorderColor Color はい はい undefined
pointHoverBorderWidth number はい はい 1
pointHoverRadius number はい はい 4
pointRadius number はい はい 3
pointRotation number はい はい 0
pointStyle pointStyle はい はい 'circle'
segment object - - undefined
showLine boolean - - true
spanGaps boolean|number - - undefined
stack string - - 'line'
stepped boolean|string - - false
tension number - - 0
xAxisID string - - 最初の X 軸
yAxisID string - - 最初の y 軸

これらすべての値がundefined、で説明されているスコープにフォールバックします。オプションの解決策

#全般的

名前 説明
clip chartArea を基準にしてクリップする方法。正の値ではオーバーフローが許可され、負の値では chartArea 内の多くのピクセルがクリップされます。0= chartArea でクリップします。クリッピングは側面ごとに構成することもできます。clip: {left: 5, top: false, right: -2, bottom: 0}
drawActiveElementsOnTop データセットのアクティブなポイントをデータセットの他のポイントの上に描画します
indexAxis データセットの基本軸。'x'水平線と'y'縦ライン用。
label 凡例とツールヒントに表示されるデータセットのラベル。
order データセットの描画順序。スタック、ツールヒント、凡例の順序にも影響します。もっと
stack このデータセットが属するグループの ID (スタックすると、各グループは個別のスタックになります)。もっと
xAxisID このデータセットをプロットする X 軸の ID。
yAxisID このデータセットをプロットする Y 軸の ID。

#ポイントスタイリング

各ポイントのスタイルは、次のプロパティで制御できます。

名前 説明
pointBackgroundColor ポイントの塗りつぶしの色。
pointBorderColor ポイントの境界線の色。
pointBorderWidth ポイントの境界線の幅 (ピクセル単位)。
pointHitRadius マウス イベントに反応する非表示ポイントのピクセル サイズ。
pointRadius ポイントシェイプの半径。 0 に設定すると、ポイントはレンダリングされません。
pointRotation 点の回転 (度単位)。
pointStyle ポイントのスタイル。もっと...

これらすべての値がundefined、最初にデータセット オプションにフォールバックし、次に関連するオプションにフォールバックします。elements.point.*オプション。

#ラインのスタイリング

線のスタイルは、次のプロパティで制御できます。

名前 説明
backgroundColor 線の塗りつぶしの色。
borderCapStyle ラインのキャップスタイル。見るMDN (新しいウィンドウが開きます)
borderColor 線の色です。
borderDash ダッシュの長さと間隔。見るMDN (新しいウィンドウが開きます)
borderDashOffset 破線のオフセット。見るMDN (新しいウィンドウが開きます)
borderJoinStyle ラインジョイントスタイル。見るMDN (新しいウィンドウが開きます)
borderWidth 線幅 (ピクセル単位)。
fill 線の下の領域を埋める方法。見る面グラフ
tension 線のベジェ曲線の張力。直線を描画するには 0 に設定します。モノトーン 3 次補間が使用される場合、このオプションは無視されます。
showLine false の場合、このデータセットに対して線は描画されません。
spanGaps true の場合、データがないか null のデータを持つ点の間に線が描画されます。 false の場合は、nullデータにより行に切れ目が作成されます。スパンするギャップの最大長を指定する数値も指定できます。値の単位は使用するスケールによって異なります。

値がundefined、値は関連付けられた値にフォールバックされます。elements.line.*オプション。

#インタラクション

各ポイントとの相互作用は、次のプロパティで制御できます。

名前 説明
pointHoverBackgroundColor ホバー時のポイントの背景色。
pointHoverBorderColor ホバーしたときのポイントの境界線の色。
pointHoverBorderWidth ホバー時のポイントの境界線の幅。
pointHoverRadius ホバー時のポイントの半径。

#三次補間モード

次の補間モードがサポートされています。

  • 'default'
  • 'monotone'

'default'アルゴリズムはカスタムの重み付け三次補間を使用し、あらゆる種類のデータセットに対して快適な曲線を生成します。

'monotone'アルゴリズムの方が適していますy = f(x)データセット: 内挿されるデータセットの単調性 (または区分的単調性) を保持し、局所的な極値 (存在する場合) が入力データ ポイントに留まるようにします。

そのまま放置しておくと(undefined)、グローバルoptions.elements.line.cubicInterpolationModeプロパティが使用されます。

#セグメント

線分スタイルは、segment物体。現在、すべてのborder*backgroundColorオプションがサポートされています。セグメント スタイルは、各ポイント間のラインのセクションごとに解決されます。undefined主線スタイルへのフォールバック。

ヒント

ギャップのスタイルを設定できるようにするには、次のものが必要です。spanGapsオプションが有効になっています。

スクリプト可能セグメントのコンテキストには、次のプロパティが含まれます。

  • type:'segment'
  • p0: 最初の点要素
  • p1: 2 番目の点要素
  • p0DataIndex: データ配列の最初の点のインデックス
  • p1DataIndex: データ配列の 2 番目のポイントのインデックス
  • datasetIndex: データセットのインデックス

使用例

#段付き

次の値がサポートされていますstepped

  • false: ステップ補間なし (デフォルト)
  • true: 補間前のステップ (eq.'before')
  • 'before': 補間の前段階
  • 'after': 補間後のステップ
  • 'middle': ステップ中間補間

もしstepped値が false 以外に設定されている場合、tension無視されます。

#デフォルトのオプション

作成されたすべての折れ線グラフに構成設定を適用することが一般的です。グローバル折れ線グラフ設定は次の場所に保存されます。Chart.overrides.line。グローバル オプションを変更すると、変更後に作成されたグラフにのみ影響します。既存のチャートは変更されません。

たとえば、すべての折れ線グラフを次のように設定するには、spanGaps = trueあなたならこうします:

Chart.overrides.line.spanGaps = true;

#データ構造

サポートされているすべてのデータ構造折れ線グラフと一緒に使用できます。

#積み上げ面グラフ

y 軸の設定を変更して積み上げを有効にすることで、折れ線グラフを積み上げ面グラフに構成できます。積み上げ面グラフを使用すると、1 つのデータ傾向が多数の小さな部分からどのように構成されているかを示すことができます。

const stackedLine = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        scales: {
            y: {
                stacked: true
            }
        }
    }
});

#縦折れ線グラフ

垂直折れ線グラフは、水平折れ線グラフのバリエーションです。 これを達成するには、indexAxisオプションオブジェクトのプロパティを'y'。 このプロパティのデフォルトは次のとおりです'x'したがって、水平線が表示されます。

const config = {
  type: 'line',
  data: data,
  options: {
    indexAxis: 'y',
    scales: {
      x: {
        beginAtZero: true
      }
    }
  }
};

#設定オプション

縦折れ線グラフの構成オプションは、縦棒グラフの構成オプションと同じです。折れ線グラフ。ただし、折れ線グラフの X 軸に指定されたオプションはすべて、縦折れ線グラフの Y 軸に適用されます。

#内部データ形式

{x, y}

最終更新: 2023 年 4 月 28 日、午前 5 時 18 分 20 秒